Update current release #120

EMaksy · 2025-11-28T10:40:44Z

Description

This pr updates the released documentation in the latest branch. I was following our our critical hotfix workflow https://www.trento-project.io/docs/developer/trento-docs-site/collaboration-docs-team/docs-git-workflow.html#_3_applying_a_critical_hotfix.
With this we have also a nice history in the commits :)

When we release Trento 3.0 we will follow this workflow
https://www.trento-project.io/docs/developer/trento-docs-site/collaboration-docs-team/docs-git-workflow.html#_2_publishing_a_new_release

Features

Added mcp docs images
Remove docker from user facing docs
Move updated docker mentions to dev docs
Update Trento support Plugin
Add docker deployment

* Remove docker from user facing docks * Remove container and docker mentions * Remove SP3 * Add env for wanda * Use vars and upcast rpm * Add explicit sle 16.0

* Fix TRNT-3895 * Add feedback

* Add local docs build * Fix selinux permission * Add workflow guide

* Restructure trento install section * Remove partial as it was included in kubernetes partial * Aligned naming of partial and added revdate to kubernetes

content/internal-notes/trento-container-install.adoc

EMaksy · 2025-11-28T10:57:20Z

content/trento-docs-site/preview-docs-with-docker.adoc

@@ -0,0 +1,36 @@
+== Local Documentation Preview with Docker


This part is just developer docs for new way of preview antora with docker

trento-docs-site/antora.yml

EMaksy · 2025-11-28T11:00:08Z

trento/adoc/trento-install-server.adoc

+:revdate: 2025-10-16

-
-[[sec-trento-k8s-deployment]]


Moved to trento-kubernetes-install.adoc[]

EMaksy · 2025-11-28T11:01:42Z

trento/adoc/trento-sso-integration.adoc

 +
 . Restart the application.

-==== Enabling OpenID Connect when using Docker images


Part of docker mention removal

EMaksy · 2025-11-28T11:01:52Z

trento/adoc/trento-sso-integration.adoc

 +
 . Restart the application.

-[[enabling-oauth-20-when-using-docker-images]]


Part of docker mention removal

EMaksy · 2025-11-28T11:01:58Z

trento/adoc/trento-sso-integration.adoc

 +
 . Restart the application.

-==== Enabling SAML when using Docker images


Part of docker mention removal

dmpop · 2025-11-28T12:00:18Z

trento/adoc/trento-kubernetes-install.adoc

+[[sec-trento-install-trentoserver-on-existing-k8s-cluster]]
+==== Installing {trserver} on an existing {k8s} cluster
+
+{trserver} consists of a several components delivered as container images and intended for deployment on a {k8s} cluster. A manual production-ready deployment of these components requires {k8s} knowledge. Customers without in-house {k8s} expertise and who want to try {trento} with a minimum of effort, can use the {trento} Helm chart. This approach automates the deployment of all the required components on a single {k8s} cluster node. You can use the {trento} Helm chart to install {trserver} on a existing {k8s} cluster as follows:


Suggested change

{trserver} consists of a several components delivered as container images and intended for deployment on a {k8s} cluster. A manual production-ready deployment of these components requires {k8s} knowledge. Customers without in-house {k8s} expertise and who want to try {trento} with a minimum of effort, can use the {trento} Helm chart. This approach automates the deployment of all the required components on a single {k8s} cluster node. You can use the {trento} Helm chart to install {trserver} on a existing {k8s} cluster as follows:

{trserver} consists of a several components delivered as container images and intended for deployment on a {k8s} cluster. A manual production-ready deployment of these components requires {k8s} knowledge. Customers without in-house {k8s} expertise and those who want to try {trento} with a minimum of effort, can use the {trento} Helm chart. This approach automates the deployment of all the required components on a single {k8s} cluster node. You can use the {trento} Helm chart to install {trserver} on a existing {k8s} cluster as follows:

dmpop · 2025-11-28T12:02:12Z

trento/adoc/trento-kubernetes-install.adoc

+[[sec-trento-install-trentoserver-on-k3s]]
+==== Installing {trserver} on K3s
+
+If you do not have a {k8s} cluster, or have one but do not want to use it for {trento}, {suse} Rancher's K3s provides an alternative. To deploy {trserver} on K3s, you need a small server or VM (see <<sec-trento-server-requirements>> for minimum requirements) and follow steps in <<pro-trento-manually-installing>>.


Suggested change

If you do not have a {k8s} cluster, or have one but do not want to use it for {trento}, {suse} Rancher's K3s provides an alternative. To deploy {trserver} on K3s, you need a small server or VM (see <<sec-trento-server-requirements>> for minimum requirements) and follow steps in <<pro-trento-manually-installing>>.

If you do not have a {k8s} cluster, or you have one but you do not want to use it for {trento}, you can use {suse} Rancher's K3s as an alternative. To deploy {trserver} on K3s, you need a server or VM (see <<sec-trento-server-requirements>> for minimum requirements) and follow steps in <<pro-trento-manually-installing>>.

dmpop · 2025-11-28T12:07:55Z

trento/adoc/trento-kubernetes-install.adoc

+Sender email for alert notifications
+
+`ALERTING_RECIPIENT`::
+Recipient email for alert notifications.


Suggested change

Recipient email for alert notifications.

Email address to receive alert notifications.

abravosuse

Great job overall @EMaksy. Just some minor changes.

If you see a suggestion that changes nothing, it's because I first made a suggestion only valid for the new version. And when I realized it, I undid my changes. Sorry.

abravosuse · 2025-12-01T14:51:23Z

trento/adoc/helm-event-pruning.adoc

I do not understand this. It says the file has been deleted, but I can still see its content in the html generated by antora.

For the record, this information should not be removed from the user facing documentation. It's relevant.

abravosuse · 2025-12-01T14:56:39Z

trento/adoc/trento-ansible-install.adoc

From this section, we should remove the reference to Docker images.

abravosuse · 2025-12-01T16:56:18Z

trento/adoc/trento-lifecycle.adoc

 // Variable List for tragent
 {tragent}::
 +
 Delivery mechanism::: RPM package for {sles4sap} 15 SP3 and newer.


Suggested change

Delivery mechanism::: RPM package for {sles4sap} 15 SP3 and newer.

Delivery mechanism::: RPM package for {sles4sap} 15 SP3 and newer.

abravosuse · 2025-12-01T16:57:51Z

trento/adoc/trento-lifecycle.adoc

Line 25: Replace "{suse} recommends {suse} {rke} (RKE) version 1 or 2" with "{suse} recommends {{rke} version". 2."

abravosuse · 2025-12-01T17:06:12Z

trento/adoc/trento-report-issue.adoc

 In case of a containerized deployment, provide the logs of the
 trento-web and trento-wanda containers. Use `+docker ps+` to retrieve


Suggested change

In case of a containerized deployment, provide the logs of the

trento-web and trento-wanda containers. Use `+docker ps+` to retrieve

Delete, also, lines 25 and 26. I could not include them in my suggestion.

abravosuse · 2025-12-01T18:13:59Z

trento/adoc/trento-requirements.adoc

-{trserver} supports different deployment scenarios: {k8s}, systemd, and containers. A {k8s}-based deployment of {trserver} is cloud-native and OS-agnostic. It can be performed on the following services:
+{trserver} supports different deployment scenarios: {k8s} and systemd. A {k8s}-based deployment of {trserver} is cloud-native and OS-agnostic. It can be performed on the following services:

 * RKE1 ({rancher_k8s_engine} version 1)


Suggested change

* RKE1 ({rancher_k8s_engine} version 1)

abravosuse · 2025-12-01T18:18:40Z

trento/adoc/trento-requirements.adoc

-*  *{trserver}* For a {k8s}-based deployment, you must have access to {suse} public registry for the deployment of {trserver} containers. For a systemd deployment, you must have a registered {sles4sap} 15 (SP3 or higher) distribution. The same applies to a containerized deployment.
-* *{tragent}s* A registered {sles4sap} 15 (SP3 or higher) distribution.
+* *{trserver}* For a {k8s}-based deployment, you must have access to {suse} public registry for the deployment of {trserver} containers. For a systemd deployment, you must have a registered {sles4sap} 15 (SP4 or higher) or {sles4sap} 16.0 distribution.
+* *{tragent}s* A registered {sles4sap} 15 (SP3 or higher) distribution.


Suggested change

* *{tragent}s* A registered {sles4sap} 15 (SP3 or higher) distribution.

* *{tragent}s* A registered {sles4sap} 15 (SP3 or higher) distribution.

trento/adoc/trento-report-issue.adoc

trento/adoc/trento-requirements.adoc

abravosuse · 2025-12-01T18:38:47Z

trento/adoc/trento-requirements.adoc


-*  *{trserver}* For a {k8s}-based deployment, you must have access to {suse} public registry for the deployment of {trserver} containers. For a systemd deployment, you must have a registered {sles4sap} 15 (SP3 or higher) distribution. The same applies to a containerized deployment.
-* *{tragent}s* A registered {sles4sap} 15 (SP3 or higher) distribution.
+* *{trserver}* For a {k8s}-based deployment, you must have access to {suse} public registry for the deployment of {trserver} containers. For a systemd deployment, you must have a registered {sles4sap} 15 (SP4 or higher) or {sles4sap} 16.0 distribution.


Suggested change

* *{trserver}* For a {k8s}-based deployment, you must have access to {suse} public registry for the deployment of {trserver} containers. For a systemd deployment, you must have a registered {sles4sap} 15 (SP4 or higher) or {sles4sap} 16.0 distribution.

* *{trserver}* For a {k8s}-based deployment, you must have access to {suse} public registry for the deployment of {trserver} containers. For a systemd deployment, you must have a registered {sles4sap} 15 (SP3 or higher) distribution.

EMaksy and others added 5 commits November 28, 2025 10:53

add images to mcp (#119)

90c205d

Remove docker and sp3 from user facing docs (#110)

c7d9b4f

* Remove docker from user facing docks * Remove container and docker mentions * Remove SP3 * Add env for wanda * Use vars and upcast rpm * Add explicit sle 16.0

Update Trento support plugin content (#101)

b4a72c2

* Fix TRNT-3895 * Add feedback

Local Documentation Preview with Docker (#114)

f886d6d

* Add local docs build * Fix selinux permission * Add workflow guide

Fix TRNT-3957 (#96)

e12398f

EMaksy self-assigned this Nov 28, 2025

EMaksy added the documentation-team label Nov 28, 2025

Restructure trento install section (#99)

539f95a

* Restructure trento install section * Remove partial as it was included in kubernetes partial * Aligned naming of partial and added revdate to kubernetes

EMaksy commented Nov 28, 2025

View reviewed changes

content/internal-notes/trento-container-install.adoc Show resolved Hide resolved

EMaksy commented Nov 28, 2025

View reviewed changes

content/internal-notes/trento-container-install.adoc Show resolved Hide resolved

EMaksy commented Nov 28, 2025

View reviewed changes

trento-docs-site/antora.yml Show resolved Hide resolved

EMaksy commented Nov 28, 2025

View reviewed changes

EMaksy marked this pull request as ready for review November 28, 2025 11:03

EMaksy requested review from abravosuse and dmpop November 28, 2025 11:03

dmpop approved these changes Nov 28, 2025

View reviewed changes

abravosuse requested changes Dec 1, 2025

View reviewed changes

Update trento/adoc/trento-requirements.adoc

c386ff5

abravosuse requested changes Dec 1, 2025

View reviewed changes

Update trento/adoc/trento-report-issue.adoc

a0e457a

	If you do not have a {k8s} cluster, or have one but do not want to use it for {trento}, {suse} Rancher's K3s provides an alternative. To deploy {trserver} on K3s, you need a small server or VM (see <<sec-trento-server-requirements>> for minimum requirements) and follow steps in <<pro-trento-manually-installing>>.
	If you do not have a {k8s} cluster, or you have one but you do not want to use it for {trento}, you can use {suse} Rancher's K3s as an alternative. To deploy {trserver} on K3s, you need a server or VM (see <<sec-trento-server-requirements>> for minimum requirements) and follow steps in <<pro-trento-manually-installing>>.

	Recipient email for alert notifications.
	Email address to receive alert notifications.

	Delivery mechanism::: RPM package for {sles4sap} 15 SP3 and newer.
	Delivery mechanism::: RPM package for {sles4sap} 15 SP3 and newer.

		In case of a containerized deployment, provide the logs of the
		trento-web and trento-wanda containers. Use `+docker ps+` to retrieve

	* {tragent}s A registered {sles4sap} 15 (SP3 or higher) distribution.
	* {tragent}s A registered {sles4sap} 15 (SP3 or higher) distribution.

	* {trserver} For a {k8s}-based deployment, you must have access to {suse} public registry for the deployment of {trserver} containers. For a systemd deployment, you must have a registered {sles4sap} 15 (SP4 or higher) or {sles4sap} 16.0 distribution.
	* {trserver} For a {k8s}-based deployment, you must have access to {suse} public registry for the deployment of {trserver} containers. For a systemd deployment, you must have a registered {sles4sap} 15 (SP3 or higher) distribution.

		:revdate: 2025-10-16


		[[sec-trento-k8s-deployment]]

Update current release #120

Are you sure you want to change the base?

Update current release #120

Uh oh!

Conversation

EMaksy commented Nov 28, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Features

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

abravosuse left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

abravosuse Dec 1, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

abravosuse Dec 1, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Milestone

Development

Uh oh!

4 participants

EMaksy commented Nov 28, 2025 •

edited

Loading

abravosuse Dec 1, 2025 •

edited

Loading

abravosuse Dec 1, 2025 •

edited

Loading